relayer
Type
command
Summary
Aids the manipulation of layers.
Syntax
relayer <control> {before | after} <layer> <index>
relayer <control> {before | after} control <target>
relayer <control> {before | after} <owner>
relayer <control> to {front | back} of <layer> <index>
relayer <control> to {front | back} of control <target>
relayer <control> to {front | back} of <owner>
Description
Use the relayer command to aid the manipulation of layers.
Use the relayer command move a control relative to a target in a number of ways. The relayer command can only be used within a card. Attempts to relayer controls from one card or another stack would throw an exception.
When using "before" the owner of the control becomes the owner of the target and is inserted before the target. The layer of the control becomes the layer of the target and the target and all subsequent controls shift up one. When using "after" the owner of the control becomes the owner of the target and is inserted after the target. The layer of the control becomes one greater than the layer of the last child of the target and all subsequent controls sift one up. When using "front" the owner of the control becomes the owner of the target and is inserted after the last child of the target (only valid if target is a container). When using "back" the owner of the control becomes the owner of the target and is inserted before the first child of the target (only valid if target is a container).
Parameters
| Name | Type | Description |
|---|---|---|
control | The target control is the given control. | |
layer | The target control is the control with layer index. | |
index | ||
target | ||
owner | The target control is the owner of the control. |
Examples
relayer button "b1" after button "b2" -- bring button b1 to front
relayer button "b1" to back of card "testCard" -- send button b1 to the back of card testCard
Related
keyword: control
property: tabGroupBehavior, relayerGroupedControls, layer
function: intersect, number, mouseControl
Compatibility and Support
Introduced
LiveCode 6.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile